MessageDlg

Category: Windows

Syntax:
MessageDlg options prompt
$MessageDlg(options prompt)

Displays prompt in a message dialog box, with an icon and a choice of buttons. The icon and buttons are controlled by options, which is the sum of the appropriate numbers from this list:

• Buttons shown:
  • OK = 0
  • OK, Cancel = 1
  • Abort, Retry, Ignore = 2
  • Yes, No, Cancel = 3
  • Yes, No = 4
  • Retry, Cancel = 5
• Icon shown:
  • No icon = 0
  • STOP icon = 16
  • Question mark icon = 32
  • Exclamation point icon = 48
  • Information icon = 64
• Default button:
  • First button is default = 0
  • Second button is default = 256
  • Third button is default = 512

If MessageDlg is called as a function, the return value depends on the button selected by the user:

• OK = 1
• Cancel = 2
• Abort = 3
• Retry = 4
• Ignore = 5
• Yes = 6
• No = 7

Example:
// show Yes, No, Cancel with question icon
@l $x = $MessageDlg(35 Do you want to save your changes before quitting?)
switch $x
  case 6:
    // yes - save changes
  case 7:
    // no - discard changes
  case 2:
    // cancel - don't quit
endswitch

See also: MessageBox

Next in "Windows": Min
Previous in "Windows": MessageBox
Next by name: Min
Previous by name: MessageBox
Up to all commands by name, all functions by name or commands and functions by category